Skip to content

Arm backend: Document validated TinyML models for Cortex-M#19078

Merged
rascani merged 2 commits into
pytorch:mainfrom
rascani:cortex-m-validated-models-docs
Apr 30, 2026
Merged

Arm backend: Document validated TinyML models for Cortex-M#19078
rascani merged 2 commits into
pytorch:mainfrom
rascani:cortex-m-validated-models-docs

Conversation

@rascani
Copy link
Copy Markdown
Contributor

@rascani rascani commented Apr 23, 2026

Summary

Adds a Validated Models section to the Cortex-M backend overview listing the six models exported, INT8 quantized, and run on the Corstone-300 FVP by CI: mv2 and ds_cnn on trunk, and mv3, mobilenet_v1_025, resnet8, and deep_autoencoder nightly. For each model the table points at the source file and the per-model dialect/implementation test. A short note calls out that mobilenet_v1_025 is the MLPerf Tiny Visual Wake Words reference model — the canonical TinyML person-detection benchmark — since that naming is not obvious from the name.

The page also documents the bundled (.bpte) testing flow that CI uses: aot_arm_compiler --bundleio embeds reference inputs and expected outputs in the program, and examples/arm/run.sh drives the full export → build → FVP chain with Test_result PASS/FAIL self-checking, so a reader can reproduce what trunk and nightly do.

An admonition clarifies that CI validates INT8 numerical parity between the exported .bpte and the eager-mode quantized model, not task accuracy (VWW / KWS / ImageNet).

This change was authored with Claude (claude-opus-4-7[1m]).

cc @digantdesai @freddan80 @per @zingo @oscarandersson8218 @mansnils @Sebastian-Larsson @robell

Adds a Validated Models section to the Cortex-M backend overview listing
the six models exported, INT8 quantized, and run on the Corstone-300 FVP
by CI: mv2 and ds_cnn on trunk, and mv3, mobilenet_v1_025, resnet8, and
deep_autoencoder nightly. For each model the table points at the source
file and the per-model dialect/implementation test. A short note calls
out that mobilenet_v1_025 is the MLPerf Tiny Visual Wake Words reference
model — the canonical TinyML person-detection benchmark — since that
naming is not obvious from the name.

The page also documents the bundled (.bpte) testing flow that CI uses:
aot_arm_compiler --bundleio embeds reference inputs and expected outputs
in the program, and examples/arm/run.sh drives the full export → build
→ FVP chain with Test_result PASS/FAIL self-checking, so a reader can
reproduce what trunk and nightly do.

An admonition clarifies that CI validates INT8 numerical parity between
the exported .bpte and the eager-mode quantized model, not task accuracy
(VWW / KWS / ImageNet).

This change was authored with Claude (claude-opus-4-7[1m]).
@pytorch-bot
Copy link
Copy Markdown

pytorch-bot Bot commented Apr 23, 2026

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/19078

Note: Links to docs will display an error until the docs builds have been completed.

❗ 1 Active SEVs

There are 1 currently active SEVs. If your PR is affected, please view them below:

❌ 1 New Failure

As of commit 563da6c with merge base cb4e5ae (image):

NEW FAILURE - The following job has failed:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Apr 23, 2026
@github-actions github-actions Bot added the module: arm Issues related to arm backend label Apr 23, 2026
@github-actions
Copy link
Copy Markdown

This PR needs a release notes: label

If your change should be included in the release notes (i.e. would users of this library care about this change?), please use a label starting with release notes:. This helps us keep track and include your important work in the next release notes.

To add a label, you can comment to pytorchbot, for example
@pytorchbot label "release notes: none"

For more information, see
https://github.com/pytorch/pytorch/wiki/PyTorch-AutoLabel-Bot#why-categorize-for-release-notes-and-how-does-it-work.

@rascani rascani requested a review from psiddh April 27, 2026 21:12
@rascani rascani marked this pull request as ready for review April 27, 2026 21:12
@rascani rascani requested a review from mergennachin as a code owner April 27, 2026 21:12
@rascani rascani merged commit 798c121 into pytorch:main Apr 30, 2026
170 of 171 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. module: arm Issues related to arm backend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants